package com.knowledgegraph.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.knowledgegraph.entity.User;

/**
 * 用户服务接口
 * 
 * @author system
 * @since 2024-01-01
 */
public interface UserService extends IService<User> {

    /**
     * 用户登录
     * 
     * @param username 用户名
     * @param password 密码
     * @param loginIp 登录IP
     * @return JWT令牌
     */
    String login(String username, String password, String loginIp);

    /**
     * 用户注册
     * 
     * @param user 用户信息
     * @return 注册结果
     */
    boolean register(User user);

    /**
     * 根据用户名查询用户
     * 
     * @param username 用户名
     * @return 用户信息
     */
    User findByUsername(String username);

    /**
     * 根据邮箱查询用户
     * 
     * @param email 邮箱
     * @return 用户信息
     */
    User findByEmail(String email);

    /**
     * 更新用户信息
     * 
     * @param user 用户信息
     * @return 更新结果
     */
    boolean updateUser(User user);

    /**
     * 修改密码
     * 
     * @param userId 用户ID
     * @param oldPassword 旧密码
     * @param newPassword 新密码
     * @return 修改结果
     */
    boolean changePassword(Long userId, String oldPassword, String newPassword);

    /**
     * 重置密码
     * 
     * @param email 邮箱
     * @return 重置结果
     */
    boolean resetPassword(String email);

    /**
     * 验证JWT令牌
     * 
     * @param token JWT令牌
     * @return 用户ID
     */
    Long validateToken(String token);

    /**
     * 生成JWT令牌
     * 
     * @param userId 用户ID
     * @return JWT令牌
     */
    String generateToken(Long userId);
}